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A BSTRACT 

Single User BASIC is a dedicated interpretive system that allows 
conversational entry and execiitton of programs written in the BASIC 
langimge as develc^jed by Dartmouth College, It includes use of all 
elementary and advanced B A S I C smtements as defined in Risic 
Programming by J. G. Kemeny and T, E. Kurtz (copyrighted 1967 
by Joim Wiley & Sons, Inc. ), but does not mclude string or matrix 
manipulatioii functions. Hie Data General implemen&tion also per- 
mits esecutioa of certain stateroents in a "desk calculator" 
or "ke y b oa r d " mode which is most useful in testing or debugging 
progra.ms as v/eEas in performing simple computations or evaluat- 
ing complex formulas without tbe necessity of writing a progiam. 
Tlie system will operate in a 4K or larger memory corifiguratioii and 
requires a teletypewriter for input/ouQjiit^ 
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INTRODUCTION 

Data General Corporation's single -user fi-A SIC' allows prc^mmmlng 
in the smnttord BASIC language using a Nova or Supernova central, processor Mth 4K 
or more memory words and a teletypewriter. It includes use of aE the elementary 
and advanced BASIC stetements as defined m B A SI C Frog ramming by 
John G. Kemeny and :TTiomas E. Kurtz (c. 1967 by John Wiley & Sons, Inc* ), 
but does not include matrix manipulatioE ftiuctions. The BA S IC language 
developed by Etortmouili CoEege allows coaversatioiml progiam entry, editing, 
execution, and input/output c^erations. The Data General Corporation 
implemenmtion also permits execution of cerain statements in a 'desk calculator' 
or ' keybcmrd' mode \^iich is most useful in testing or debugging programs as 
well as in performing simple computations or e-mluatlng complex formulas 
witiiout the necessity erf writing a progiam. Tlie purpose of this write -up is 
to inform the user of operating proc«iureSt including error messages » and 
to provide a brief summary of the B A S I G smtements available, ginning 
programmers s or programmers not familiar with the use of BASIC are 
referred to the above mentioned book ^ Kemeny and Kurtz. 
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T::. cinar;.- taps of sinsi'^' "scr 3A3IC is ioadec! like any otiaer absolute binary 
riirx- by the binary loader. Once loaded; the BASIC system telces control and the 
first tas'-' it performs is to d'JtcTmjj./i* tiic size of ncii^ory it has to operate in. 'Vlien 
'<ie sysreni fi;ids itself m a 4K em^iTon^.ent it types out the question: "DO YOU WISH 
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SIN, COS, ATN At© TAN (TYPE Y OR N)7 " 



If :::;3 'j-cr r.:?":t!C'3 -rA e Y As cere r^-r-Ared for Aese functions is made STailable 
for storage of user's Dro^'am and data., tliereby e^qjandiiig Ae total storage STailaMe 
for ttiis purpose by sixt}^ p-erceat. TTie number cf spaces rqii^sented by a comma in 
a PRMT smtemeEt may now be selected to be eifrier 14 or 15. Once selected^ the 
system will treat the full page as either 70 or 75. TTius, the function TAB will reduce 
its argument modulo 70 or 75, etc, (See "PRINT and TAB"), TTie foUowliig message 
wlE be typed: 

"DO YOU WISH COMMA'S TO BE 14 SPACES (TYPE Y), OR 15 (TITE N)? " 
Tli€ appropriate key, Y or N may tben be typed. To change the number of spaces 
represented by commas the system must be reloaded. It then initializes itself and 
in that process destroys the binary loader^ but it leaves imact the bootstrap loader. 
If it finds memory is larger tlmn 4K words, it \¥ill preserve both the binary and 
bootstrap loaders and Mil use tiie additloml core to store the user's data and program. 
Hence, larger memory configurations provide the user with the capability of handling 
larger programs with larger bodies of data. After it has sized memory and initialized 
itself, tiie BASIC system performs a carriage -retttm/liHe -feed on the teletypewriter, 
and waits for ttie user to respond. 

M at some point in working wiHi the system tiie user wishes to restart Ae program, 
due to a power fatture for example ? he may do so by setting the Nova/Supemova panel 
data smtches to the restart address (000002), and pressing the EESET and START 
operating switches. Hiis action wiH place the system in a state of suspended anlmatloii 
until the user strikes the ESC key on the teletypewriter. All other teletypewriter keys 
will give no response untE tiie ESC key is Mt. When struck it wiE cause liie system to 
do a carriage -return on the teletypewriter aad type the message "*IIEADY". 



Restarting BASIC does not destrof ^mpmgmm ot dam tMt the met had entered 
previously. To accomplish iMs the user must issue tiie keyboard command *WEW", 
wMch causes &e user's progmm area to be clmmd m prepamtton for a aew progmm. 
The keyb^oard command NEW. always ^ed Mthomt a prececlng line number, can be 
given at any point, and is not necessanly comected wltfi restarting tfie system. Thus, 
if during the entry and editing of a progmm, or foEomng the execution of a prcgram. a 
NEW command ^s given, it woiM also clear the user's progmm area. 

Entering and Editing a Program 

Tlie BASIC system is ready to acc^t prc^mm satemeits from Ae teletypewriter 
at any point exc^t during execution of a program. Even during execution, it is possible 
to halt a program by Mtting the ESC key. aad then to eater addifioiial statements or 
altemtions to slatements and to re-enter or re-smrt tbe totem^ited progism. Each 
line of a program is entered by typing a statement number foEowed by tte smtement. 
When statements are not preceded hf a statement number, the BASIC system will 
attempt to execute the statement in keyboarf mode if that is possible, and if it is not, 
the system will retom an error message (usually error 12). Smtement or line numbers 
must be integers, and tiiey are limited to a maximum of four digits. Lines are termi- 
nated by typing a carriage -rettira, and spaces are permitted at any point on a line, 
iacludiiig before the line aumber. Spaces teve no significaiice in B A S I C. except in 
messages enclosed in quotetion marks wMch are to be prmted out. 

To correct errors made while typing a smtement, two keybmrd commaads are 
available: "caitrol A" and "conttol X» . Tlie user can delete (rub out) the preceding 
character in a line by pressing down the CTRL and Ae A keys ("control A") which mH 
print on a tele^ewriter as a teckwarfs arrow "-". He can Aen type in the correct 
character. Pressing "control A" a number of times will erase from liie current line the 
characters in that number of preceding spaces. To delete all of tiie present line, the 
user should press the CTRL i^y and the X key ("control X") which wiE print as a back™ 
wards slash "X, and atttomatically cause a carriage -return and a line-feed on a tele-^ 

typev/rlter, 

if. after ha\diig entered a program, the user vashes a listirxg of his program, he 
.::;:_ o.3;ai:: one. sir.-l/ hy Tj'pin;, the kiybcard ccmraard '^LiST^' Miowed by a cairia^^ 
r:,-:,:ra. T^ J.s.S IC sysccm vaD dien prcdi.ce a llstia- of die pro-nim as ii currently 
stands in line Btimber sequence, 
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The command LIST has two forms: 

LIST List entire ptogram* 

imiimLIST List entire prog^m storting 

at statement number nimn. 

If Ae s&temeat number ca^nnot be found, the message 

ERR 13 

I- z::r :r fcor^-n, the llsttng may be stopped at any time witli tiie use oi tlis ZSC key. If 
tho 'JEsr v.ish-^-3 a pai^r mpe copy of bis program he may obtain one by tiicnlr^.y 0:1 &c 
teletypewriter punch unit Just before he types the carriage -return at the end of >4f^ ? "--"►T 
commanci. T2.e tape produced may then be relmded at a later time by niountlnt It on the 
teletypewriter reader and moving the coitrol switch to START (See Appendix A). After 
remewmg Ms listed program, the user may desire to alter some line or lines, TMs can 
be done by typing, the line number of the statement to be chaBged followed by the new or 
revised statement. To eliminate entirely a smtement in his progmin, the user need 
only type the line number of the smtement followed by a carriage -retum. Addltloiial 
lines may be inserted in, a program by typing statements witfi intermediatB line numbers ^ 
ie, if a stotemeat is to be insert«i between lines IpP and lip tfie user simply types a 
line number of say lp5 followed by the stetemeit he wishes to insert, 

Keybo?4,rd !v!cde 



Data General Corporation' s .BASIC system wlE accept cerain statements 
B^preceded by line numbers and execute them immediately. These keyboard commands 
are: RUN, NEW, LIST. PRINT, GOTO, DIM, LET, REM. RESTORE, and the ESC key ^ 
on the teletype\¥riter. They are useful in testing and dd^uggiiig programs, and Aey also 
allow the system to be used as a simple desk calculator. 

After typmg a complete program, -the user causes sequenilal execution of Ms pro- 
gram to begm starting at ttie tavest steitement aiimber by typing the keyboard command 
"RUN" foEowed by a carriage -return. If llie program is correct, it will be run and will 
cause whatever ou^ut Is specified in the program to be printed on the teletypev/riter. 
Errors detected after RUN are stmctmml (incorrect nesting of loops, GOSUm without 
matching remrns) or ariUimetic errors. Grammatical errors or errors of form are 
not possible at tims point, because th^ are previously detected during Ae typing of each 
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statement. If it is obvioiis that the pTogmm niimiBg is giving Ae wrong answers, the 
user can Mt tlie ESC key oa the teletypewriter wMch mil cause computation to cmse and 
the BASIC system to type "STOP § XXXX" ^ere X^:X is the Mne number of tlie ste.te- 
ment about to be executed when eiBcution was interrupted. Tte user can then inquire 
what the values of program variables are by means of the PRINT statement. For 
example, if A is a variable in the user's progiamt he can find its value at tim time of 
intern^tion by simply typing "PEINT A" ami the BASIC system mil reply with the 
values. When using PRMT (or ;) in the keybcmrf or desk calculator mode, only the 
expression i^ to the first comma, semi -colon, or carriage -rettim will be printed. For 
example, 

; 1,2CCR) 
will respond wftfi 1. He may also ctonge the mbm of a variable or variables before 
returning to program conttol by means of the LET command. If tm wishes to change the 
value of A to 15 the user may give the teybcBKi command "LET A = 15". 

ii much the same way it is possible foHowing such an intem^Jtion to redimension 
a previously defined array by entering a DIM smtement with the same array name« Ihis 
redimensioning does not in any way effect the amount of storage or the coatents of stor- 
age previously allocat«l by a DIM program statement. It neither es^mnds nor coatiacts 
the storage available, but in the two-dimensional case it changes the subscript address 
which refers to a given entty. For es-mple^ if the user had d^ned a 3 x 4 array A in 
his program by means of a DIM A(28 3) prc^am statement, and, after interrt^tlng 
executtoa, gave the keyboard command DIM A(3, 2) to redimensioa A as a 4 x 3 array^ 
the array would be transformed as fllustrated: 

12 3 12 



o i 



C; l! 2- 3= 4 = I 1 i 2 ! 

s — _i__»i 1„ _ 

2i 9ac'll ii2 ! ; 



7 1 



4. 



7 



3 ilO j 11 ! 12 



Thus, entry A(1,0) v/hich conmlned a 5 must subsequently be referenced as A(l, 1); 
e-tr/ ix(0. 3) irriust be refcrcacai as A(L 0); entr^r Af2, 2) must be referenced as A(3, 1% 

-::, It ^.-.oiiid '^e r.c.iec diiit rec:i;:.c:i:,lof:irii; is confiriCd to trcnsf-Trmi^g nn otmy into 
oae mfli iie same or fewer imlu'jOts c£ entricc-, and that subc-cript references outside 
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"c: -:■■;>'.■:; ('j:?nsior:^^In2" a 3 r: - 1:: ^ :• :t. 3) it -.73uld C2:isc en error to use a 3 ::5 :i cc5r:;u: 
subscript or.ce tlic reclimcnsionirig had talcen place (A(2; 3) would generate error 3X). 

Du-ri:^7 ::n ir.tcr?:rptj -:: user may oiso restore- v^e data Meek pointer to t-ae top cf 
tac dafa r;l^c!: ay ias'dny tlia kcybaard command "RESTOHE", He iray Irscrt a .'iaa 
af ccrraierts at ?.ay paint 121 a.^ycaard node aimply by yraaeaiay ta.e ccra,nicat3 aa'li 
"?£! r\ Ja a liac riia"aar is tiyjad, dae ccir.a:aat5 fcllaa^irg .REal mall ba storad a? a pro- 
yraia. statement, but as a }:eyboard command tec comments aali aat be retained. 

To re,si:me exeaudiCii a? a program folloaaBg a programmed STOP or ke^/baard 
intemi>tion, the user mmst %'pe "GOTO XXXX" where XXXX is the line number of the 
statement at which the prc^am should be re-entered. If tiie user types "RUN" aE 
variaMes and arrays in the prc^ram wiE be re-initiaJlzed to zero, a RESTXJRE will be 
ececuted on Ae da& block, and tiie program will be smrted a^in from ifie lowest stote- 
ment number, 

C-round Rules ciiMmiiberst Variables, A ra.ys, and Expressions 

Numbers handled by Data General Corporation* s single user BASIC are 
coastraiBed as follows: 

Input - 7 signfficant digits 

Ou^t - 6 slgnificaiit digits 

Internal - 23 signlflcaiit bits 

Range - Positive Powers: 

"23 l''*'' 38 

+ (1-2 ) (2 *■") = + L70141 X 10 

Negative Powers: 

-127 -19 

± 1/2(2 l"^! 2.0x10 

¥ariable aames in BASIC must consist of a single letter or a single letter fol- 
lowed by a single digit. Some acceptable variable names would hfi A, A7, Q, QB, etc* 
Variable names such as IX, SR, and Y23 wotdd be regarded as errors. 

li addition to ordinary ¥ariables B A SIC allows the use of array variables to 
designate elements in an array. Arrays may be of one or two dimensions and array 
names must consist of a sin^e letter. Ars-y names and simple variable names must 
be distinct, ttie single letter used to daiote an array name may not be used as a simple 
variable name. It is most efficient to declare an array by means of a dimension (DIM) 
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statement in a prc^ram, but tliis is not necessary if tfc subscript (s| wlB not exceed 
Ae range of to 10. M no DIM statement for an aosy is given in a pTOgmm the BA SIC 
system will, upon encountering a reference to the army m some stetementt automatical- 
ly attocate stomge lor 11 entries (1 x 11) i£ the army rrfereice showed only a single 
dmensiai, or for 121 entries (11 x 11) if the ansy reference showed two dimensions. 
In light 'Of tMs it behooves the user to conser^/e progmm storage space by declaring 
smaE armys Mth a DM statement, particularly if he is working in a 4K environment. 
If tihe user requires arrays larger than 1 x 11 or 11 x 11 he must declare them with a 
DIM smtement Dimensions are limited to the mn^ < dimension < J55. An array 
may not have nore tlmn 1024 entries. 

Ej^resslons in BASIC can be constractai using simple variables, armys, and 
functions linked to^&er by parentiieses and the following five arithmetic operators: 

SYMBOL EXAMPLE MEANMG 

4. X+Y AASition (add X to Y) 

X-Y Subttaclion (subtract Y from X) 

* X*Y Multiplication (multiply Y by X) 

X/Y Division (divide X by Y) 

3.2 
I Xf 3.2 Raise to the power (find X ) 

(Single User BASIC computes Af B 1^ means of die Identlly A^B EXI»Cff*LOG(A)). 
TMs may result in some slight arithmetic errors in the sixth decimal position of the 
result. In ad€ticm, an aridimetic error (EER 16) will result if A is ne^tive* To mise 
variables and ccmsmnts to integer expcments, multlplicatioa should be used ratfier than 
ei^oaenaatton if this slight arithmetic error is obJectioimMe. ) 

ParenAeses are used to enclose eube^ressions wMch are to be treated as entities 
witim the larger egression. The computer evaluates an egression beginning widi the 
Is'-A'fst sur-expresslor.s and moves upwards until the whole is evaluated. WitMn each sub- 
o.-p-rcssion arithmetic operatlcns are performed in tlie usual precedence adopted for 
co:iii:.uXT iLn-iin'^-is: first cr^-pc-r.cntia-aons; th'^n miiltjplicatloiis and/or divisions, and 
ia-tly additions and/ or subtractions. In the absence of parentfieses in an expresslcm in- 
voiving operations of tx.e same priorir/, die operations are performed from left to right. 
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SUmARI OF BASIC COMAWS 

LET 

This stetement is used to Instruct the BASIC system to perform a computotioa 
and assign the value otjtained to a ▼ariailc. Each LET statement is of tfie form: 
LET ^aridble ) - kspmssion % The smtement can be executed as a program stetemeiit, 
or, v/hen not preceded by a line number, it can be executed immediately as a keyboard 
command. For example, 

100LETX= x^x-^x+a 

255 LET Y = Z - 24 + Xf 3. 32 

LET X = 2 + 5 * A 

EEAD, DATA, and RESTORE 



The READ smtemeiit is used to retrie¥e values stored in DATA statements and to 
assign these values to ttie variables specified. Neitlier the READ statement nor the 
DATA statement can be ussd without the other, A READ statement causes the variables 
listed in it to be assipied, in order, the next available numbers from the whole body of' 
DATA siatemenlB. It should be mentioned here that before nnming a program, the 
BASIC system assembles all the DATA satements, in the order v/Mch they appear 
la the program (line nuinber sequence). Into a single large date Mock. Thus, whenever 
a READ statement is encountered during executioa, the BASIC system remoTCs the 
next a¥ajlable uimsed entry or entries from tiie data block and assigns these values to 
fee variable or variables specified in the READ statement. Normally, EEAD statements 
are placed in the program at tiiose points where the data is to be EiarJ.piilated, but the 
placement of DATA stotements is arbitrary so long as tliey are in the correct order and 
the programmer keeps in mind that the data will be collected into a single Mock. For 
this reason, it is a common practice to collect aE daia statements and place them to- 
g-thtr at the begir.ning or end of a program. It should be remembered that only numbers 
are permitted in DATA stetements and that formulas such as SQR(3), 17 3, 16*7, and 
15/9 will be rejected as errors. Also, READ and DATA statements are only accep&ble 
to the system as program statements and may not be executed as keybcard commands. 

If it is necessary to use data stored by DATA statements more than once in a 
program? the user may reset tiie date block pointer to the first number In tfie data 
block by means of the RESTORE smtement. Hius, ¥/heiie¥er a RESTORE smtement is 
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encoTMtered in a program, a subseqi^nt EEAD statement will begin reading from the top 
rf Ae block created bf tfie DxiTA smtements. If tiie date v/Mch tfie programmer wlslies 
to reuse will not be stored at tfie top of Ae dam Mock, te must ®ke care to insert Ae 
correct number of dummf EEAD steteuients to move the pointer do^i the block to the 
MU he desires. Hie RES'TOEE statement may also be used as a keyboard command. 

MPUT 

The INPUT smtement is used to permit mtry erf date from tfie teletypewriter dur- 
ing the nimiiiig of a program. It serves the same fenctiaii as a READ smtement. but it 
does not rehire a DATA smtement from ^Mch to draw numbers. ' Further, ^ta entered 
wiA an INPUT statemeat is not saved wi&to the progmm. The statement is accep&ble 
only \fllMn a program and may not be used as a keyboard command. 

Whea an INPUT smtement is encoimtered duriag execution, the BASIC system 
types a question mark and waits for the user to enter the value for the argument. The 
user responds with a number terminated by a carria^ -return. M more than one argu- 
ment Is specified in Ae INPUT statement liie system wiE assign to the first argumeat 
the first value typed in. It wiE respond wllh aaother question mark. The user should 
tfien type the value to be assigned to the second argument, and if a tfiird argument is 
speckled, the system wlE respond mA a Aird question mark, etc. , until values for all 
the arguments have been entered, at wMch point the system imil automaticaEy continue 
ej^eciitloii of the program. Each value must, of course, be terminated by a carriage - 
retiim as it is typed. K the user makes an error in typing a number (he types a comma 
Instead of a decimal point, for example) the computer vdE return a bacfovards slash 
»\: foEowed by another questSon mark, and he must enter the value a^ln. Frequeat- 
ly, KPUTs are preceded ^ PRMT statemeat coatainiDg a message to inform the user 
what tlie qrestioii mark signiftes. For esmplet 

100 PEINT " T» ¥ALUES OF A,Bt AKD C AEE"; 
110 INPUT A, B,C 

aad during execution the computer types: 

Tlffi ¥ALUES OF A, B, AMD C ARE f 

Note tfmt the semicolon at the end of the PRIMT statement causes the computer 

to tipe tfie questton mark at Ae end of tiie message Instead of on the next liae. 
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Ipp 


PEMT 


2PP 


PRMT 


3PP 


PRMT 


4ii 


PRMT 



conr-riar.d to cayse priTxtin.g op2r':!.*z.or.3 on the Tclct/pi;. (Tb'-^ special character b:cr"i- 
cc-lcn (;) ma^/ be used iiiterclmngeably witbx the word PRHxT. On listing, it will be cori - 
verttd to PRI>!T. ) As a statement in a progxim it can be used a) to print resi-lts of 
comprxtctions, b) tc print verbatim a messa^ stored m tfie program, c) to print a 
co}rJ^i:-i".ticn of «-he Pro, and d) to ski^ a line. As a keyboard command it caii be n-ed 
e) te pr!.nt the value of ¥ar?.ables denned in Ae user's pr^iam or functfons of these 
varirilee, and f) it can be used tc print tM results of computations on Humbers in desk 
calculator fasMon. Some ejamples of hov/ the PRMT stetement may be used in a pro - 
gram are: 

"X¥ALUE", "SINE", "COSINE" (b) 

X, SIN CX), COS (X) (a) 

"THE SQUARE ROOT OF"; X; "IS"; SQR (X) (c) 

Cd) 

Formatting of oulpiit from a PRINT stetement Is automaticaay performed hy the 
system unless tiie user specifies anotber format for Ms ou^ut. Whenever the arguments 
of &e PRINT statement are separated by commas the B A S I C system employs automatic 
formatling under which liie teletypewriter line is divided into fi¥e zcnes starting at 
positions p, 15, 3p, 45 and 6p. (If tbe comma has been initialized to represeat 14 
spaces, ijie five zones would start at positions p 14, 28^ 42, 56. ) Each comma in tbe 
PRtt^T statement causes tte system to mo¥e to the nejct zone b^ore typing tiie value of 
tbe next variable, or, if the fifiii zone has been filled, to move to the first zone of the 
neM line. Hie end of a PRINT statement signals a new line and causes a carriage - 
return/line "feed on the teletype unless this action is suppressed by placing a comma (or 
semicolon) at tbe ^d of tte PRD^T stetemeat. 

The user may override automatic formattiiig to specify compact fonnattrng or 
particular Ime formats by means of tiie simicolon and tbe TAB functioii. Compact 
f ormattings or elimination of spacing betiveen tiie pnntfng zones of the arguments being 
printed, is caused by tiie use of tbe simicolon to separate tbe variables in Ae PRINT 
ste-tement. For example, the statement 

Ifp PRINT X.Y.Z 
would cause the values <rf the mriables X, Y and Z to be priiit«i under automatic 
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formattiiig on a single teletypewriter line begfaning at print positions ^ P» 15, and Sf 
respectively; whereas the smtement - 

Iff PRMTX:Y:Z 
would cause the values of ttie tiiree variables to be printed <m a slii#e line bepnnlng at 
print posMoa p f/itb m spacing between each of tfie argument's print zones. The size 
and spacittg witim each of tiie ¥ariable*s print zones depends on the value aad type of tbe 
number bang printed as described below. The caret symbol, t^ , represents a space 
%rped on the teletypewriter. K tbe absolute value of tbe ¥ariable is in ttie mn^ 10 
< ¥aiiable < 10 or if the absolute value can be rqjresented exaclly as a six -digit 
decimal fraction, then fixed format is used. Non-sl^uficant leading and trailing 
zeros are suppressed. The decim-:! point is omitted from integers, 
examples: 
-.001 

Floating format is used in aE other cases and has the form % d.dddddE^ie where each 
d is a decimal digit and ee is a one or two digit exponent of ten. Numbers are preceded 
by a minus si^ or a space and are fctlowed by a ^ace. 

TAB- cl auses or functions, each with an argument of its own, may be inserted in 
PEMT smtements to cause the Teletype to move to specific positfons on the Hne before 
printing tte variables. The ar^ment erf the TAB fimction may be either an integer or 
aa egression aad is evaluated modulo 70 or 75 dependJjig upon wheliier the space has 
been initialized to r^resent 14 or 15 spaces respectively- If it is the latter, the value 
of the e^ressicm will be computed and its integer part taken. If the comma has becE 
initialized to represent 15 spaces^ tliea the value of the argument is greater than 71 or 
less than 75 tfie teletype vdE print at the end of the current line. There are orly 72 
vrir-r pcsliiciis on a telcc/pevrrf-ter, rxuir.hercd f through 71. Commas foUoMng TAB 
-iL-.ise:. hcYx., iio effect oix oe-s: :l Drlr.^r, out ceramas foEov/iiig arguments will cause auto- 
-/•/Ic f^r:r:ir::r<4 ur-l/css r::c r.e'-r .'.rr^Jiriuni: is preceded by a TAB fcjiction. 

I: ±c user. havlr,g niternx-rco a prccraia's execution by striking the ESC key, 
7,lo,r„s re know the current velue of the prcgram variable X, he may employ the PRINT 
stet-iir.erit as a he^'board comi.-iaiic'. If he types 

-SiNT X ^^/ 

~ir-z-: it .-;reo.:-;/r , Irie nurr.^-er, r.e v/:.^c --.ur.^ ree ccrrent value of this var::. ;.i^ .- '■: . 
- -=;---"^d -"ei; v.:,J' f'/hiov.-r:.- tr.c ire^h-iarJ coxir.er.'... A af..:r who at any time ms'"-^:-- z--^. 
perform a quicle calceiation may ao so using the P^-.hv'I ycatement or a combine, .-^ce c^ e.. 
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LET and PRMT statements in keyboard mode. 
For example, 

PRINT SQE C5*5+12*12) 

or 

LET (^(5*5+12*12) 

PRMT SQR CQ) (f) 

wfll cause the system to return tfie square root of (5 '-h 11^) on tfie same line as tr.z- 

PRMT commands, 

GOTO 

The GOTO smtement is used to direct the flow of execution m a program and may 
be employed as a keyboard command* When a GOTO sUtemmt is encountered in a pro- 
gmm it causes the system to coatiniie execution from the liae number specified. It is 
possible to transfer control to a non -executable statement (a DATA smtement, for ex- 
ample) In which case control passes to the next sequential executable stetement. For 

es.mple, 

5p DATA 2.0.3.1416,7,8.4.1 
60 LET X1=SQR(B*B-4*A*G) 

2pP GO TO 50 
IF-THEN (IF -GOTO) ' 

The IF-TtffiN statement is used to cause branching to another point in a program 
when a comditloii is fulfilled. For this reason it is also known as a conditional GOTO 
statement and is typed by the system as IF -GOTO when the keyboard command LIST is 
given. Both IF-THEN and IF -GOTO are perfectly acc^table Yariations of the statement 
for input to the system. Most commoaly. the IF-THEN smtement will have the form: 

IF [ expression J [Telational operator 1 I expression J TffiN 
[ line wjjrbei* ] Thus, a smtement to cause brancMBg %vheii the variable A was not 

equal to 2 would be 

IPPIF A 02THEN5P 

where the concatenated symbols "<>" mean "is not equal to". 

In a mathematically more general sense, the IF-THEN stetement would have the 

form: 

IF [ expressior. '] THEN [line number I 
where the ^ression is evaluate and tte result treated as true when non -zero, or 

"12" 



false when equal to zero. Using this form the abciwe e^mple would become 

m IF A - 2 GOTO 50 
TMs would cause the system to &ke Its next instructioE from line number 50 so long as 
A does not equal 2, If A = 2 control would pass to the next sequential instxuctton foEow- 
Ing IJae ipp. 

The first form is mo^ rmdily readable and is thus more often used. The following 
six smndaxd relational operators are permitted: 

SYMK)L EXAMPL E MEANMG 

= X = Y Is equal to .{X Is equal to Y) 

< X <Y Is less tlmn 4X is less than Y> 

<= X <= Y Is less than or equal to .(X is less 

than or equal to Y) 

> X > Y Is greater than 4X is greater than Y) 

> = X > = Y Is greater than or equal to .(^ Is 

greater than or equal to Y) 

<> X <> Y Is not equal to .(X is not equal to Y) 

The IF -THEN statement may not be used as a keybcmrd command, 

FOR> NEXT, and STEP 

The FOE and NEXT sUtemeiits^ and the STEP clause are used in setting up and 
operating a loop in the user's program. They mtist always appear together: the FOR 
ste-tement. wiA or wlthoiit a STEP specified, at the entrance to^ the loop; and the NEXT 
stetement at Ae exit, poMting back to the ent^mce. 
Every FOR statement Is of the form 

FOR [ var^d-lc I = [ ^::cprces-ion ] TO icx^r^ssion ] STEP [ esz^reseicn ] 
wriere the variable may oe ar.y ncnG-abscripteci variable. Most often, the eicpressions 
vE: b- i-tejcrs v^Y:r, the ST2r zyidsc cixittcd iii which cJ.se the svf^teiii csc-.;:iies £. step 
Gizc of n 1. :;atc tiiat w::e;i 3pecili-^d, the £t.p--^iz£ rsik^y ee aii QxpT'':s -sioii -//eicn refa-v^.:. 
r;. i:her £ po2l:i:.-e or iie^jev-e ii:i:TLDer. Kccie ico teet the FOR and XZXT stexei^ers ere 
eot eeeeptehle as kcyboaii conin^e^ils, 

GCSU3 and RETURN 



:^C£U2 erid rETTRIx etoicinc -ts ere used to treeef^r cov.tcol to. asct r.earn 
/rce^'e'e-\ vi tet u%€e^;: eeieejei, Ve^ ir-eeeviree:-. ly. cettr^^^. e' ei-.^,---; -e .. 
, I. ™ce" ee::ev- the .^r-eriiczt i- ere dev me i:;er c-f ei^ ursz eeeiet.ei e, .e-, 
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'■-7'"'/:^ \ir no aiT'i^/C-::t} direc^i^-i: the co'^^iputer to return, co^itrol vo Ac s'lti,^^-^"-;^: i-/ - 
= n^-jTi- the 'SOSUB that called irc subrood^^, GOSU-3:? mev be "ee?*:ee. ** tf^^X i-\ ■':■ : 
srbreiitine mav call anc&crj hut it is iieccssar>^ tl^at each oiiJ-jroutirc be exile.:', by 
.!lETe'P^: statement when it completes its work. This is because actaal return addrcs - 
,;e3 ere stored in a push-do^m list as each G0SU3 is executed and must be piclced olf 
by RI:TUE>: sratcmect? in the rcTcrse sequence. If the user exits a siibrcutirc:- 03- 
neans of e GOTO i-n.?teed of a Il5TU;e>' it is extreniely liSrely that he will foul rh- 
eorreet e-as-fa^re ef eor'rel bet^.veen Ie\'e!s of E'jhrcetlues, This dcee not mean thet it 
is inpcselhfc to use several RETURM statements in a given suhroutiBC if it is to tc 
exited at seveml different points, but that tte user should keep in mind how the system 
works, GOSUK may not be used as keytMard commands. 



DIM 



The DIM stotement is used to Inform the system to allocate a specific amount of 
storage for a one or two-dmensioiial array with a given name. Array names must 
consist of a siii#e letter. One-dtmensional arrays may have a mammum of 256 
entries ( , DIM A (255) since there will be a zeroth mtiy) and two-dlmensionai ar- 
rays may have a mamnmm rf 1024 CBtries ( , DIM B (31, 31) or DIM C (15, 63) since 
there will be both a row $ and a colunm p. For example, the statements 

Ip DIM X (17) 
2p DIM Y (14,9) 
would cause the BASIC system to aHocate storage for a one-dimensioiiai array, X, with 
18 entries, and for a two-dimensional array, Y, with 15p eBtties, 

Fimctio ns and DB F 

A) Standard Functloiis 

Data General Corporation's single iiser BASIC allows the use in egressions of Ae 
five ariiiimetlc operatioris (addition, subtractiont multiplication, dvisioa, e^onentia" 
tion, +, -. *t /, # ) and the elwen fmictioiis normally defined for BASIC. The arguments 
of these functions may tliemselves be egressions. The eleven functions are: 
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Function Meaning 

SM (X) ' ' Find tbe sine erf X ] ^^^ ^ .^ toterpreted 

COS (X) Find the cosiBe of X ') as an an^e measured 

i in radians 
TAN (X) Find the Tangent of X 



ATM (X) Find the Arcangent of X (restdt stressed in radians) 

EXP (X) Find e^ 

LOG (X) Find the natuml logarithm of X (InX) 

SQE (X) Find the square root of X ( ^| 

ABS (X) ^ ^ . Find the absolute vatoe of X ( j X| ) 

SON (X) Find the sign of X 

INT (X) Find the largest integer < X 

RND (X) Generate a random number between p and 1 

Most of these are well Masm functicms aiM need no e^lanation, but the follomring few 
comments should be noted. 

The arguments of the functions SIN, COS. TANt ATM and ABS are confined to the 
range of acceptable real numbers (2 x 10 < |xj< 1.7 x 10 ). 

^ The LOG and SQR fuactioas require their arguments to be positive. 

A negative or zero argument in the LOG function wiU cause the system to respond 

widi Ae largest possible negative number (~L70141 E+38) plus an error message 

(error 16). A negative argument in the SQR fanction will cause the system to respond 

with the square root of the same positive number plus an error message (error 16). 

The argument of the E^ functioE is confined to those values which will genemte 

88^ ^ _38 ., 
the largest and smaEest acceptable real numbers, eg ,e = 1.7 x 10 and nence 

arguments greater than 88 wiE cause the system to return 1.70141E+38 as the answer 
along with error message 16. 

The SGN function generates as its result a -fl if its argument is a positive number, 
a f if its argument is a zero, ar.d a -i If its ari.-iiment is a negative nember. Thus, 
SG>: : ^52) = I: Z-Zm CP.PPI = p, and SG2x (-24.8) = -1. 

Tn< i:\T liincdon yields as its result th^ liirgcst integer less than or equal to (not 
grw-:tcr ti.an) iis argument, where the argument is limited to a six digit number ¥#lth 
abFolute value less than 2^"^ cr 2. 147, 483. 648. Arguments of larger absolute value 
will l.'^ r^:;j.xc; t i t 2a-i7^-^Z-r^. The IXT fu;ie:ici: is frequently usee in rocndf-- 
op..':-.r:.-i:; . 1X7 ;::- C] vi-.! round X to it-: ncar^-st liitc-.'^r. ■viii.rv.r.s .XT ii:"^-^ X'/IC- 
wi/ c"-s-:.K.i-. --..t- dccir.v,.-? place, or^ moxt, r^ciicr-llv, IXT {iED'^X-r 5)/iLi/ v-".-! 
rou-.id X to B decimal places. ^- c. 



^^_,j^,^-_, ,^,j_^/^. ^ '-ti- f\Tr c • 



r'-e ioTT-. of tis frr.ction reqii:'res ar argLimcnr, it lias no sicrriicar.c:. a'lC a-.v nir--'?..r 
->- pre-.-ic'-Jsly duf i?ed var^iils* ni-r-? cc suDS-dmUd as the ar.rimcnt. 

B) DEF 

Tiie DEF Statement Is used to define as functioiis those egressions m«ch a 
pro-ramirer uses several rimes is the course of Ms progmm, and which he wishes 
to abbr.-Yiate after hsvir- «?-C£- wzltm them. The name erf each defined fimction mttst 
consist of three letters, the first mo of wMch are "FN" . Hence, up to 26 funetiais 
may be defined, eg. FNA, FNB, . . , , FNZ. For esmple, a function equlwlent 
to X^+ e^''*^ could be deftied by the line 

50 DEF FNT (X) = X*X + EXP (3X + 2) 
ThBtmftBT fa Ms piogmm the user would caH for various values of the fonctton 
simply by using FNT (2,4), FNT (-0. 1), FNT (A), etc, A DEF statement may occur 
anywhere in a program, and Ae expression to the right of the equal sign may be aay 
formula wMch can be fitted on a single line. It may include any mmbimtioJi of oAer 
functtoas, including ones defined by other DEF statements, and it can in¥ol¥e tther 
variables besides the one denoting *.e argument of Ae fmctioii. Functions are not 
actoally d^ned until the DEF Smtcment has been executed. 



STOP 



The STOP smtemeat is used to cause a halt in the execiitton of the user's pr^ram 
at Bwj point. When a STOP is encomtered, the BASIC system will cease execution of 
the user's program, type the message "STOP i XX.^", where XXXX is the lime num- 
ber of the STOP smtemmt, and wit for the user to type in addMonal program stete- 
ments or alterations to siatemeats, or, to type m a keyb«.rd command. 

REM 

TTie REM statement is used to insert explanatory remarks in a program. 
Everything foHo^ving the EEM is stored exactly as typed and Is reproduced when 
a listing is requested by a LIST stetemeat. The BASIC system completely ignores 
the whole smtement diirlng execution. For example, 

1§$ REM THIS IS A REL'IARK STATEMENT I 
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END 

The END satement Is used to signal the ead of execiiiloii of a program* Every 
pr^^m must have an END stetement and It is often assl^ed the highest line number 
in the program. Its form is: 

9999 END 
After an END statement Ims teen executed the BASIC system will inform the user that 
it has completed processing of the program, bj typing tiie message "*READY", 
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APPENDS A 
Punching: a Tar;e of a Usct*s Fro;;rarr. 



To punch a BA S I C pr(^mm Mpe with blank leader and trailer, foEow this 
procedure: 

1. Turn the power switch oa the front of the teletypewriter to the LOCAL posMon. 
Press the ON button on tq) erf tbe tde^e punch unit. Hiai press the IffiRE IS* 
key to pouch blank &pe, Wten enough blank m.pe 1ms been produced press Ae OFF 
button on top of the punch imit and. ttmi Ae po^r sMtch back to tlie LWE posMon* 

2, I>pe tbe Keyb^jd command LIST, but do not press the RE TURN -key yet. 
Press the ON button oa tc^ of the Metyi^ punch unit and tiien piess Ae RETURN 
key. After waiting until Ae punching and UstiMg is complete press the OFF button 
on the teletype punch unit, 

3* Repeat st^ 1 to punch a length of blank lamller on the tape. 

4. Remove the tape by pulling stimigM i^. This praiuces arrows cm tlie ends of the 
tape to indicate the dtrection in which the tape should be r^d through the r^der. 
It is usually wise to write the imme of the prc^ism cm tim impe for msy identification 
at a later time. 

* On some teletypewriters the HERE S key may not punch blank tape. 
In tMs case the user -should hold down CTRL, SffiFT, REFT, and P keys 
simuieiieously to punch blank tape. The REFT and P keys should be released first* 



^A2- 
Loading a T ape^rf a User's Program 
To load a BASIC program mpe, follow tMs procedure: 

1. Set tiic sv^tch on the teletypewriter's paper tape reader to the STOP posMon. 
Release the plastic tape guide cm the mpe reader and mount tfee bediming end 
cf the tape in the r^der wMi the arrow at the end of the tape pointiiig for\¥arci 
and tie piMched portion han^g down behind. Be sure the sprocket holes in the 
tape leader are fitted on the sprocket wheel. - 

2. Close tfie plastic tape guide and mo¥e liie smtch on the rmder to the START 
posMon, Wait until tiie entire tape Ims beoi read and Hsted, and uhen move 
the reader switch to tlie FREE position, and puE out liie remaining tape. 

Note : Before Icmding a tape of a B A S I C progmm it is usual to ^ve the keyboard 
command ''NEW" which clears the user's space of aE slatements. " M a NEW 
command is not ^ven, the progmm wiE still be Icmded, but any statements 
premously stored which bear the same line numbers as statements in the 
program being leaded wiE be.rgjlaced by the sfetements from the mpe. 
Statements wltii Ime numbers not used in the prc^ram being Icmded mE not 
be affected. TMs f^-ture is useful in loading subroutines or portioiis of 
prcgxams from several pieces of tape. 



APPENDIX B 
Pro|yrainm Jr.g rlj.nts 

The following suggtsticns arc offc-red in fee- interest of making the most 
'jftlciciit use of user's stor?-g-&. Tr-cs^- hmts become important if a Storage O/er- 

flow error occurs wMle enteriag or mmliig a pr^r!i:Ti» 

1, Enter data wttch clmnges for each rim bj m^ns of I? .TUT smtements ratter 
than by READ and DATA s&tements. 

2, Keep remarks (REM stetements') to a mMmuin. 

3, Re -use imrlables and army s used mrlier to the prc^iam if Ae dd ^ltie(s) will 
no longer be needed, 

4» Dimension all arrays, 

5. Dimension arrays as closely as possible to Ae largest subscripts that will be used. 

6. Utilize the zeroth column and row of arrays, 

7. Wtiere^er possible uliE^ one lengthy satement (such as READ, DATA, INPUT, 
or PEMT) Instrnd of two or more statements to accomplish the same results, 

8. Define functions (DEF smtemest) whenever the same egression will he used at 
least tv/ice in a progxam. 
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Short Summary of BASIC Statements 
1. Elemeatary BASIC 

READ Reads das from dam block 

DATA Stores das in date Mock 

PRMT Types numbers and labels 

; Same as PRMT 

LET Computes aad asslpis value 

GO TO Transfers coEtrol 

IF Condittonal tmasfer 

FOR Sets up and operates a loop 

NEXT Closes lo<^ 

END Final statement in program 



E^.mple 
5PREADX, Yl, M0,3) 
5f DATA -1, 2 J7. 31416E -4, 127829 
5P PRmT/'ANSWER="; X 

5pLETX3=X+Y 2 

5p GO TO 175 

5P IF T(I,J)=25 THEN 175 

5p FOR N=10 TO 1 STEP -1 

50 NEXT N 

SPEND 



Advances BASIC 

INPUT Reads date from tiie Teletype 

Defines a ftinctioii 
Transfers to a subroutine 



DBF 

GOSUB 

RETURN 



RESTOEE 
REiVi 



5p INPUT X, Y4. Z 

5f DBF FNG (X) = 2* SIN (X) 

5P GO SUB 8p 



Returas caitrol from subroutine 

to statement follo\¥ing GOSUB 50 RETURN 

Restores date, block pointer to 

begimiiig of dam Mock SP RESTOEE 

Permits comments S§ REM ffiGMNMG OF SUBROUTME 

Declares dimeasioiis of arrays Sf DIM B (3, 5) 

Stops program 5p STOP 



Clause used in PRINT 
ste-tement 



5# PRMT TAB C2*A+5); "*" 



3. Notes 



Variables Sin^e letter or sli^le letter plus sln^e 

digit 

Army Names Single letter 

Arithmetic 

C^erators +, -^ *, / ? 

Relattonal 

Chelators <,< =j =,>,>=,< > 

Funclioiis SQR, SM, COS, TAN, ATN, LOG, EXP, A^, 

SGN, m% RND 



APPENDIX D 
Sin^e-User BASIC Error Messages 

00 Format Error 

01 Illegal Chamcter 

02 Sfimx Error 

04 System Error 

05 Illei^l Satement Number 

06 Too Many Variable Names 

07 SpeEmg Error 

08 SpeEing Error 

09 No Such Word 

10 Mcorrect Subscript Closure 

11 Incorrect ferenttiesis Oosure 

12 Not A Keyboard CommaiMi 

13 No Such Line Number 

14 Stora^ Overflow (?#Mle lapetting PTOgram) 

15 R^d Statement Is Out Of DslW. 

16 Arithmetic Overflow (Number Too Large) 

18 Too Ma-nj Nested GOSUBs 

19 Too ybny RETURNS 

20 Too Many Nested FORs 

21 FOR Without NEXT 

22 NEXT Witiiottt FOR 

23 Out Ot Stora^ (?#Mle Assigning Variable Storage) 

24 Array Too Large 

25 Attempt To Dimension Simple Variable 

26 Variable Name Is Not Dimensionable 

28 Redimensicmed Array Is Larger Than Previously Defined 

29 Expression Is Too Complex 

30 Mle^l Format In Defined Fimction 

31 Subscript Exceeds Dimension 

32 Undefined User Functloii 

33 Too IMnj Nested Functions 

34 Negati¥e Subscript 

35 Fiiiiction. Not Yet Implemented 



